Skip to content

doc: add arm64-musl info into platform list - #61589

Draft
kleisauke wants to merge 2 commits into
nodejs:mainfrom
kleisauke:arm64-musl
Draft

doc: add arm64-musl info into platform list#61589
kleisauke wants to merge 2 commits into
nodejs:mainfrom
kleisauke:arm64-musl

Conversation

@kleisauke

@kleisauke kleisauke commented Jan 30, 2026

Copy link
Copy Markdown

See:
https://github.com/nodejs/unofficial-builds/blob/main/recipes/arm64-musl/Dockerfile

Follow-up to #61569.

Note that I considered adding riscv64 here as well, e.g.:

--- a/BUILDING.md
+++ b/BUILDING.md
@@ -116,6 +116,7 @@ platforms. This is true regardless of entries in the table below.
 | GNU/Linux        | ppc64le >=power9 | kernel >= 4.18[^1], glibc >= 2.28 | Tier 2       | e.g. Ubuntu 20.04, RHEL 8            |
 | GNU/Linux        | s390x >=z14      | kernel >= 4.18[^1], glibc >= 2.28 | Tier 2       | e.g. RHEL 8                          |
 | GNU/Linux        | loong64          | kernel >= 5.19, glibc >= 2.36     | Experimental |                                      |
+| GNU/Linux        | riscv64          | kernel >= 6.8, glibc >= 2.39      | Experimental | e.g. Ubuntu 24.04                    |
 | Windows          | x64              | >= Windows 10/Server 2016         | Tier 1       | [^2],[^3]                            |
 | Windows          | arm64            | >= Windows 10                     | Tier 2       |                                      |
 | macOS            | x64              | >= 13.5                           | Tier 1       | For notes about compilation see [^4] |

but there's already a PR open for that, see #42251.

@nodejs-github-bot

nodejs-github-bot commented Jan 30, 2026

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/build
  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to Node.js builds or CI infrastructure. doc Issues and PRs related to Node.js documentation. labels Jan 30, 2026
@kleisauke kleisauke mentioned this pull request Jan 30, 2026
Open
@sxa

sxa commented Jan 30, 2026

Copy link
Copy Markdown
Member

but there's already a PR open for that, see #42251.

Yeah I was thinking about that one too when I wrote the previous comment. The unofficial builds were broken on there for a while but I've now got them mostly working again so now's the right time to look at pushing that one forward again :-)

@kleisauke kleisauke mentioned this pull request Mar 2, 2026
Open
@kleisauke
kleisauke marked this pull request as draft March 2, 2026 14:59
@kleisauke

kleisauke commented Mar 2, 2026

Copy link
Copy Markdown
Author

Marked as draft due to dependence on #61569.

@kleisauke
kleisauke force-pushed the arm64-musl branch 3 times, most recently from a168b2e to 980135e Compare March 2, 2026 16:46
@kleisauke
kleisauke force-pushed the arm64-musl branch 2 times, most recently from 5959847 to e412ef0 Compare May 6, 2026 14:42
@kleisauke
kleisauke force-pushed the arm64-musl branch 2 times, most recently from 9d3849a to 5f38a1c Compare June 26, 2026 18:35
@kleisauke
kleisauke force-pushed the arm64-musl branch 2 times, most recently from 65c870c to a19e59b Compare October 2, 2026 09:02
@kleisauke
doc: reorganize platform list into separate headings
6021154 
Signed-off-by: Kleis Auke Wolthuizen <github@kleisauke.nl>
@kleisauke
kleisauke force-pushed the arm64-musl branch 2 times, most recently from 4c5ae37 to 070fe8a Compare October 4, 2026 11:07
@MikeMcC399

MikeMcC399 commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

linux-arm-musl is not built or tested in the official Jenkins environment, so I'm unsure if it should be added to the official list at all.

In https://github.com/nodejs/docker-node/blob/main/README.md#supported-architectures for the Docker builds, where we do build Node.js Docker images for Alpine 3.23 & Alpine 3.24 we list linux-arm-musl as untested. We don't even say there that they are experimental. It's more "AS-IS" status. (In practice though, these builds do work, otherwise we would have had feedback that they didn't!)

@MikeMcC399

MikeMcC399 commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

This is also related to the request #66394 to make linux-arm64-musl Tier 2.

The discussion in the issue also refers to the missing infrastructure to build and test.

@kleisauke
doc: add arm64-musl info into platform list
6ccb218 
Signed-off-by: Kleis Auke Wolthuizen <github@kleisauke.nl>
@kleisauke

kleisauke commented Oct 4, 2026

Copy link
Copy Markdown
Author

As per the comment at #61569 (comment), I aligned the kernel requirements and notes with linux-x64-musl.

linux-arm-musl is not built or tested in the official Jenkins environment, so I'm unsure if it should be added to the official list at all.

Just wondering, are linux-loong64 and linux-riscv64 also not tested? They're both listed as experimental tier in this list.

@MikeMcC399

MikeMcC399 commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

Just wondering, are linux-loong64 and linux-riscv64 also not tested? They're both listed as experimental tier in this list.

The set of machines is currently in flux. Issues are on https://github.com/nodejs/build/issues and there's also a Slack channel - nodejs-build.

@richardlau

richardlau commented Oct 5, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

As per the comment at #61569 (comment), I aligned the kernel requirements and notes with linux-x64-musl.

linux-arm-musl is not built or tested in the official Jenkins environment, so I'm unsure if it should be added to the official list at all.

Just wondering, are linux-loong64 and linux-riscv64 also not tested? They're both listed as experimental tier in this list.

We are testing linux-loong64 and linux-riscv64 in the Jenkins CI.

@MikeMcC399 MikeMcC399 added the alpine Issues and PRs related to the Alpine Linux platform. label Oct 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@lpinca lpinca lpinca approved these changes
@anonrig anonrig anonrig approved these changes
@cjihrig cjihrig cjihrig approved these changes
@sxa sxa sxa approved these changes

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

alpine Issues and PRs related to the Alpine Linux platform. build Issues and PRs related to Node.js builds or CI infrastructure. doc Issues and PRs related to Node.js documentation.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

8 participants

@kleisauke @nodejs-github-bot @sxa @MikeMcC399 @richardlau @lpinca @anonrig @cjihrig